Skip to content

docs: Add Help Center pages for space KPIs - #320

Open
shiroyasha wants to merge 3 commits into
mainfrom
docs/kpis-help-center
Open

docs: Add Help Center pages for space KPIs#320
shiroyasha wants to merge 3 commits into
mainfrom
docs/kpis-help-center

Conversation

@shiroyasha

Copy link
Copy Markdown
Member

Summary

  • Add a KPIs section to the Help Center covering intro, create, log, edit, annotations, comments, edit/delete updates, and delete.
  • Cross-link from Spaces, Space tools, space access control, Review, and Features overview.
  • Note that KPIs appear when the space tool is enabled (and may not be listed for every company yet). Screenshots are not included yet.

Test plan

  • Preview /help/intro-to-kpis and each KPI how-to page in the sidebar
  • Follow links from Introduction to Spaces, Space tools, Space access control, Review, and Features overview
  • Confirm UI labels match the product (New KPI, Log update, Add annotation, Recorded updates, Delete forever)
  • Optionally add screenshots later (KPI card, list, detail, log dialog, Review row)

Made with Cursor

KPIs shipped without product help. Document create, log, edit, annotate, comments, and delete, and link them from spaces, tools, access, and Review.

Signed-off-by: Igor Šarčević <igor@operately.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 7, 2026

Copy link
Copy Markdown

Deploying operately-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 9465d63
Status: ✅  Deploy successful!
Preview URL: https://525320a4.operately-website.pages.dev
Branch Preview URL: https://docs-kpis-help-center.operately-website.pages.dev

View logs

Drop company-availability caveats from the Help Center copy.

Signed-off-by: Igor Šarčević <igor@operately.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
<ImageEnhancer />

Space admins can enable or disable the following tools for each space: Documents & Files, Discussions, Tasks, and Templates. This helps keep each space focused on the workflows that matter and hides sections your team does not use.
Space admins can enable or disable the following tools for each space: Documents & Files, Discussions, Tasks, Templates, and [KPIs](/help/intro-to-kpis). This helps keep each space focused on the workflows that matter and hides sections your team does not use.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the other tools are not linked, why this?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch. Removed the link, so KPIs reads like the other tools in that sentence. The "See Introduction to KPIs" link stays in the Available Tools list, matching how Templates links to Project templates.


import { Steps, Aside } from '@astrojs/starlight/components';

Annotations are dated markers on the KPI chart — a launch, a pricing change, or another event. They are not logged values. Clicking a marker opens it so you can edit or delete it.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

avoid —

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed. Swept the em dashes out of all the new KPI pages, not just this line.

#### View Access

Users can see the space and its accessible content, including documents, tasks, and non-secret goals and projects.
Users can see the space and its accessible content, including documents, tasks, [KPIs](/help/intro-to-kpis), and non-secret goals and projects.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why is only KPI linked.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unlinked. KPIs, KPI updates, and the Edit Access bullet are now plain text like the surrounding content types. The KPI how-to pages are still reachable from body text via Introduction to KPIs.

Stop linking only KPIs where sibling tools and content types are plain
text, and drop em dashes from the KPI pages.

Signed-off-by: Igor Šarčević <igor@operately.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant